ACADEMICFIX STUDIO — İSTEĞE BAĞLI YEREL SÜRÜM
0.6.1 · Windows · 3 Ekim 2026

AcademicFix Studio'nun ürün yönü web üzerinden kullanımdır. Bu paket,
ofisini kendi bilgisayarında çalıştırmak isteyenler için yerel seçenektir.
Tek kullanıcı içindir; yalnız bu bilgisayardan erişilebilir.

ÜÇ ADIMDA AÇIN
1. ZIP dosyasına sağ tıklayıp “Tümünü ayıkla” seçin.
2. Açılan klasörde “AcademicFix Studio.cmd” dosyasına çift tıklayın.
3. Tarayıcıda ofis açılır. İlk kullanım rehberiyle bir model bağlayın.

Node.js 24 veya daha yeni bir LTS sürümü gerekir. Eksikse başlatıcı size
resmî kurulum adresini gösterir: https://nodejs.org/en/download
Kurulumu kendiniz tamamlayıp başlatıcıyı tekrar açın. Başlatıcı yazılım
indirmez, kurmaz veya yönetici izni istemez. Ek npm paketi gerekmez.

Tarayıcı açılmazsa başlatma penceresinde yazan 127.0.0.1 adresini açın.
Başlatıcıya tekrar çift tıklamak aynı kullanıcı için açık olan doğru
Studio oturumunu yeniden kullanır. Varsayılan port doluysa boş port seçilir.

KAPATMA
“Studio'yu Kapat.cmd” dosyasına çift tıklayın. Devam eden model işleri
durdurulur, kayıtlar korunur. Yalnız tarayıcı sekmesini kapatmak yerel
sunucuyu durdurmaz. Bilgisayar yeniden açıldığında başlatıcıyı kullanın.

VERİLERİM NEREDE?
Windows'ta: %LOCALAPPDATA%\AcademicFixStudio\data
Bu adresi Dosya Gezgini'nin adres çubuğuna yapıştırabilirsiniz.
Belgeler, sohbetler, görevler ve bağlantı tanımları kullanıcıya ait bu
klasörde tutulur; ayıkladığınız kaynak klasörüne yazılmaz. Yeni sürüm
indirildiğinde aynı kullanıcı verisi kullanılır. Güncellemeden önce
çalışan eski sürümü “Studio'yu Kapat.cmd” ile kapatın.

Ayarlar > Kayıtları dışa aktar, API anahtarı ve oturum belirteci içermeyen
JSON verir. Tam yerel yedek için Studio kapalıyken veri klasörünü kendi
güvenli yedekleme alanınıza kopyalayın. Bu klasörü başkalarıyla paylaşmayın.
Kaynak ZIP'i kullanıcı verisi, hesap oturumu veya örnek sohbet içermez.

MODEL BAĞLAMA
Modeller > Aboneliğimi bağla yoluyla başlayın. Tüm ajanlar aynı modeli
kullanabilir; farklı ajanlara farklı bağlantı ve modeller de atanabilir.

- ChatGPT: OpenAI'nin resmî giriş ekranını kullanır. Hesap ve plan
  uygunluğunu OpenAI belirler. Girişten sonra hesabın model listesinden
  seçim yapın, kısa yanıt testini tamamlayın ve ajanlara atayın.
- Claude: Değiştirilmemiş resmî Claude Code 2.1.248+ yerel kurulumu ve
  Claude hesabınızla giriş gerekir. Kurulum yönergesi:
  https://code.claude.com/docs/en/quickstart
- Ollama: Bilgisayarınızdaki yerel modeli bağlayabilirsiniz.
- Gemini aboneliği: Bu sürümde doğrulanmış bağlantı sunulmuyor.
- API: Ayrı ücret doğurabilecek API bağlantıları ancak siz seçerseniz
  kullanılır. Abonelik sorunu olduğunda ücretli API'ye otomatik geçilmez.

Bağlantı testi ve ajan yanıtları kullanım tüketir. Sağlayıcı hesabınızda
ek kredi/aşım açıksa ek tüketim oluşabilir; Studio bu hesap ayarını veya
faturayı teknik olarak sınırlayamaz. Uygulamadaki bildirim, ayarın sağlayıcı
hesabında kapatılmasının yerine geçmez.

ChatGPT oturumu Windows kullanıcı hesabına bağlı şifreli kasada saklanır.
Claude girişini resmî CLI yönetir. API anahtarları yalnız açık sunucu
sürecinin belleğindedir; Studio yeniden açıldığında tekrar girilir.
Barındırılan web ürünündeki hesap/onay koşulları yerel bağlantıdan ayrıdır.

KULLANIM PANELİ
Claude'un normal çalışması sırasında gelen resmî kota bildirimleri, ölçüm
zamanıyla gösterilir. Eksik veya eski oranlar tahmin edilmez. Kota yenileme
düğmesi model çağrısı yapmaz. ChatGPT bağlantısı sayısal kalan kotayı
otomatik paylaşmadığı için resmî kullanım sayfasına yönlendirir.

OFİSTE NELER YAPABİLİRİM?
- On hazır ajan, iki boş ekip yeri ve kendi araştırmacı karakteriniz vardır.
  Adları, görünümleri ve talimatları değiştirebilir; ajanları ekipten
  çıkarıp geçmişini koruyarak geri ekleyebilirsiniz.
- Belgeleri ekleyin, bir ajana görev verin, ortak sohbet veya konu odası açın.
  İki ajanla tartışma başlatabilir, gerçek yanıtları yerel sesle dinletebilirsiniz.
- Ajan talimatını kendiniz yazabilir veya Prompt Mühendisi'ne hazırlatabilirsiniz.
  A9'un çalışan modeli olmalıdır. Taslak, “Taslağı kullan” ve “Kaydet”
  adımlarınızdan sonra kalıcı talimat olur.
- İsteğe bağlı kalite denetimi, tamamlanan çıktıları başka ajanlara
  değerlendirtir. Her beş geçerli değerlendirmede iyileştirme toplantısı
  yapılabilir. Puanlar model değerlendirmesidir; bilimsel doğruluk garantisi değildir.
- Açık/koyu/sistem teması ve yeniden açılabilen başlangıç rehberi vardır.

BELGELER VE MEVCUT SINIRLAR
TXT, Markdown, CSV ve JSON metinleri; DOCX ve PDF metin çıkarımı desteklenir.
Dosya sınırı 10 MB, çıkarılan metin sınırı 500.000 karakterdir.
DOCX/PDF için Python, PDF için ayrıca pypdf kurulumu gerekir. Bunlar otomatik
kurulmaz. Python hazır değilse belgeyi düz metin olarak ekleyebilirsiniz.
Tarama OCR'ı ve sayfa düzeni çözümlemesi yoktur.

Bu sürüm metin üretimi ve araştırma işlerinin düzenlenmesine destek verir.
Web tarama, dosya düzenleme, R/Python analizi ve tam özerk araştırma araçları
henüz uygulanmadı. Modelin analiz önerisi, analizin çalıştırıldığı anlamına gelmez.

SORUN GİDERME
- “Node.js gerekli”: Resmî siteden 24+ LTS kurun; açık eski terminali kapatıp
  başlatıcıyı yeniden açın. Yönetilen bilgisayarda kurumunuzdan destek alın.
- “Eski sürüm halen açık”: Önce kapatma dosyasını çalıştırın, sonra yeni sürümü açın.
- Ofis açılmıyor: Veri klasöründeki startup.log dosyasında başlangıç hatası bulunur.
- Belge okunmuyor: Python/pypdf kurulumunu kontrol edin veya düz metin kullanın.
- Ajan yanıtlamıyor: Modeller ekranında bağlantı ve seçilen modeli sınayın.

TEKNİK KULLANIM
Başlat: node server/launch.mjs
Tarayıcı açmadan: node server/launch.mjs --no-browser
Kapat: node server/launch.mjs --stop
Veri yolu: ACADEMIC_OFFICE_DATA_DIR ortam değişkeniyle seçilebilir.
Python: ACADEMIC_OFFICE_PYTHON ortam değişkeniyle yürütülebilir dosya seçilebilir.
Sunucu yalnız 127.0.0.1 üzerinde dinler. Uzaktaki ağlara açmak desteklenmez.
